Add a New Page

Click on the Pages tab in the Project Explorer.

Right-click anywhere in the tab and choose New Page from the context-sensitive menu displayed. Alternatively press Ctrl+N.

A new page will be added to the end of the form and a new thumbnail will be displayed for it in the Pages tab.

Click on the Project tab in the Project Explorer.

Right-click on the Pages node in the project tree view.

Choose New Page from the context-sensitive menu displayed.

A new page will be added to the end of the form and will appear in the tree view under Forms ➝ <form name> ➝ Pages.

You can add a new page by copying and pasting an existing page in the usual way from the context-sensitive menu available in both the Project Explorer's Project and Pages tabs. Right-click on a page's name in the Project tab's tree view or on a page thumbnail in the Pages tab to display the menu and choose Copy, to copy the current page, or Paste, to paste in the copied page. When you paste in a page, it will be added to the end of the form.

You can also use the standard keyboard shortcuts Ctrl+C and Ctrl+V to copy the currently selected page and paste a copied page to the end of the form, respectively.

 

Once you've added a new page you might want to change its configuration or its position within the page sequence:

To change the position of a page within the form:

Click on the Pages tab in the Project Explorer.

Either:

  • Click and drag the page within the Pages tab and drop it in its new position

    or

  • Right-click on the page thumbnail of the page you want to move.

    Choose Move Page Up or Move Page Down, as required, from the context-sensitive menu displayed. Repeat as many times as needed to move the page to its new position within the page sequence.

You can rename a page in the usual way from the context-sensitive menu available in the Project Explorer's Project tab. Right-click on the page's name in the Project tab's tree view to display the menu and choose Rename.

Select your new page, if not already selected, to display its properties in the Properties Pane:

Name

By default pages are named Pagen, where n is a number starting with 1 for the first page and incremented by 1 for each new page added. We suggest you change the name to something more meaningful which reflects its content or purpose within the form. You can give a page any name you like, although it can only contain A-Z, a-z, 0-9 and '_' and cannot start with a number. The name must be unique within the form and you cannot use the same name for a page and a form within the same project.

In addition, we recommend that you don't give your page a name which corresponds to any reserved words. Reserved words are words which are used internally within Digitise Forms or have a special meaning within JavaScript and generally cannot be used for user-definable items, such as a page name. For example, you should not call a page: submit, onsubmit, history or images, although SubmitPage, OnSubmitForm etc. could be used. For a list of typical reserved words see: https://www.w3schools.com/js/js_reserved.asp.

Note that right-clicking on this field and choosing Reset to default will clear the field.

 

Code Name

This is the name of the page as you need to refer to it within any custom JavaScript functions you add to the form. Note that the name spelling here is case-sensitive and must be used in your JavaScript exactly as it appears here.

 

Title

Allows you to enter a title for the page, which will be displayed in the Navigation Bar Elements, if used, to identify this page to users of the form.

The properties found under the Appearance Tab are used to customise the behaviour of a Navigation Bar Element added to the Header or Footer of the page. For details about using these properties refer to the Navigation Bar description in the Digitise Forms User Guide.

The Nonsequential property allows you to specify whether pages have to be navigated in sequence or not and this property also affects the behaviour of the Next, Previous and Go To Page Elements and the equivalent functionality accessed via Events or in custom Javascript - for more information refer to the topics: Next Button, Previous Button, Go To Page Button, Events, Event Properties and Customise Forms with JavaScript.

You may also need to change the default setting of the Nonsequential property when using a Recordset Element configured to display a separate edit page for adding and editing data listed in its table.

  • If you are using nonsequential pages in your form, we recommend that you place them at the end of the page sequence within the Pages Pane. This will make navigating your form simpler.

 

On Show

Allows you to assign custom actions to be performed when this page is displayed at runtime. Leave blank it you don't want to customise the page load. If you do want to add custom actions, you can choose from a list of predefined actions or, for more experienced developers, you can provide custom actions by coding your own JavaScript which will be run when the page loads. Custom actions can be added to the page On Show Event in the same way as adding actions to Element Events - for more information refer to the topics: Events, Event Properties and Customise Forms with JavaScript.